Using cubemap textures

Cubemap textures combine six square-shaped images into one texture to represent reflections of the environment. Each image represents the scenery in one of the six directions along the X, Y, and Z axes from the viewpoint of the cubemapped object.

Before you can create a cubemap texture in Kanzi Studio you first have to create the texture images of the six cube faces for the cubemap. You can create the six texture images in the third-party tool where you created the mesh object on which you want to use the cubemap texture, and import the images to Kanzi Studio.

Make sure that all faces of a cubemap texture use images of the same size and format. When size and format of the images in a cubemap texture do not match, Kanzi Engine converts them during the loading of your Kanzi application using the CPU of the target platform. This can significantly increase the amount of time it takes to launch your application.

For example, use for all faces of the cubemap texture images that are 256 by 256 pixels large and are 8-bit grayscale.

When the size and format of images in a cubemap texture do not match, Kanzi Studio prints these warnings to the Log window:

Application WARNING: The faces of the cubemap texture '<TextureName>' use images of different sizes.
	To improve the performance of your application, make sure all faces use images of the same size.
Application WARNING: The faces of the cubemap texture '<TextureName>' use images with different data formats.
	To improve the performance of your application, make sure the images of all faces use the same data format.

Creating cubemap textures

To create a cubemap texture:

1. In the Library right-click Materials and Textures and select Create > Cube-map Texture.
2. In the Properties set the Cube-map Images properties to their respective images you want to use for your cubemap texture:
   • NegZ Image to the negative Z-face of the cubemap (the back plane)
   • PosZ Image to the positive Z-face of the cubemap (the front plane)
   • NegX Imageto the negative X-face of the cubemap (the bottom plane)
   • PosX Image to the positive X-face of the cubemap (the top plane)
   • NegY Image to the negative Y-face of the cubemap (the right plane)
   • PosY Image to the positive Y-face of the cubemap (the left plane)
     
   To use the texture on a mesh, assign the texture to a material that supports cubemap textures. See Creating textured materials.

See also

Using single textures

Using render target textures

Creating textured materials

Images

Material types and materials

Importing

Open topic with navigation